Claude模型在国内的使用比较一言难尽，但Claude Code作为最优秀的AI Agent产品，仍然值得每个使用AI工具的人一试，而为了能够丝滑地使用 Claude Code，经常需要切换到国产大模型。
网上给出了很多的Claude Code切换其他模型的教程，还有人专门做了一个应用来实现模型的切换，但是其中最简单的方法还是通过直接修改 Claude Code 的JSON 配置文件，尤其是在多个大模型中进行切换的场景下，这种修改方式更为迅捷和简便。
JSON 是什么
JSON 是一种用来表示和传输数据的文本格式，全称是 JavaScript Object Notation。作为一种机器容易读、人也勉强能看懂的数据格式，JSON被广泛用于配置文件、接口返回数据、程序之间传递数据。虽然名字里有 JavaScript，但现在几乎所有编程语言都支持 JSON。
一个最简单的 JSON 长这样：
{
"name": "Claude Code",
"enabled": true,
"timeout": 3000000
}整个 JSON 用一对大括号 {} 包住，里面每一项都是”键: 值”的格式——键是配置项的名字，值是对应的内容。键必须用英文双引号括起来；值的类型不只一种，上面例子里出现了三种："Claude Code" 是字符串，也就是文字内容，用英文双引号括起来，true 是布尔值，表示开或关，不加引号，3000000 是数字，同样不加引号。
值也可以是数组，用方括号表示，里面放多个值：
{
"models": ["model-a", "model-b", "model-c"]
}此外，值还可以是一个嵌套的对象，也就是在某个值的位置再放一对大括号，里面继续写键值对，我们要修改的Claude Code 的 settings.json 配置文件，就是这种嵌套写法。
{
"env": {
"ANTHROPIC_BASE_URL": "https://example.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_MODEL": "model-name"
}
}env 是”环境变量”的缩写，它是 Claude Code 启动前要读的一张参数表：读完这张表，它才知道该连哪个服务器、用哪个模型、凭什么 Key 来访问。切换模型，就是设置这张表里的几个值。
修改配置文件以切换到国产模型
想要在Claude Code中自由切换使用国产模型，需要修改两个配置文件。
考虑到JSON文件格式要求比较严格，最好使用 VS Code 这类编辑器进行修改，这类编辑器会把格式错误的地方标红，如果出错能够马上定位到。
先修改 .claude.json 跳过登录验证
由于Claude Code首次启动默认会引导登录使用自家模型，所以如果此前没有使用过Claude Code，需要先修改 .claude.json文件，具体文件路径在
Windows：用户目录/.claude.json
macOS / Linux：~/.claude.json如果文件不存在，新建并写入以下内容；如果文件已存在，在其中追加 "hasCompletedOnboarding": true 这一字段：
{
"hasCompletedOnboarding": true
}这一项的作用是告诉 Claude Code”引导流程已经完成了”，跳过 Anthropic 官方的登录初始化，让Claude Code读取下面要修改的配置文件。
在 settings.json 里写入环境变量
Claude Code 的用户配置文件放在：
macOS / Linux：~/.claude/settings.json
Windows：用户目录/.claude/settings.json需要新建或者修改的是settings.json 的 env ，基本内容如下（以DeepSeek为例）。但“env”后面的大括号内具体要填那些键值对，不同模型提供商不完全一样，需要查阅模型提供商的 Claude Code 接入文档。
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "YOUR_DEEPSEEK_API_KEY",
"ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
}
}ANTHROPIC_BASE_URL 决定请求发到哪里，用DeepSeek就填DeepSeek的地址，用 Kimi 就填 Kimi 的。
ANTHROPIC_AUTH_TOKEN 是访问凭证，通常是模型提供商后台生成的 API Key，比如DeepSeek开放平台。
ANTHROPIC_MODEL：所使用的模型名称，部分模型提供商会在接口层自动完成模型映射，不需要在 settings.json 里指定；但也有模型提供商需要明确写出模型名，具体以模型提供商文档为准。
重要：JSON文件的多个配置项（键值对）之间需要用英文逗号分隔，但是大括号内的最后一项后面则不需要逗号。这点需要特别注意，多一个逗号少一个逗号都可能会导致 Claude Code 无法正确读取配置文件。
添加 env 后怎么确认是否生效
改完配置后，重新启动 Claude Code，可以查看界面上显示的模型信息是否已经切换为目标模型，然后随便问一个简单问题，确认能正常回复。
需要说明的是，有的模型提供商（比如智谱）为了实现无缝体验，进入后看到的可能还是Sonnet 4.6这种官方模型名，这不一定是配置失败，具体还是发一句话看看是否回复。
多个大模型提供商如何切换
如果经常在多个国产模型提供商之间切换，可以把几组配置都放在 settings.json 里，但只有一组使用标准的 env 名称。以下示例生效的是DeepSeek，因为使用了标准字段名 env，其余三个字段名envark、envzp、envkc Claude Code 无法识别，其内容将会被程序忽略。
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "YOUR_DEEPSEEK_API_KEY",
"ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
},
"envark": {
"ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
"ANTHROPIC_AUTH_TOKEN": "YOUR_ARK_API_KEY",
"API_TIMEOUT_MS": "3000000",
"ANTHROPIC_MODEL": "ark-code-latest"
},
"envzp": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_ZHIPU_API_KEY",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"API_TIMEOUT_MS": "3000000"
},
"envkc": {
"ANTHROPIC_BASE_URL": "https://api.kimi.com/coding/",
"ANTHROPIC_AUTH_TOKEN": "YOUR_KIMI_API_KEY",
"API_TIMEOUT_MS": "3000000"
}
}如果要从DeepSeek切到 Kimi，可以把当前的 env 改回 envds，再把 envkc 改成 env，保存文件后重启 Claude Code即可。需要确认不要同时出现两个 env。
有个细节需要注意，有的提供商coding plan和开放平台的API key是不能通用的，配置也是不一样的，需要注意区分。
如果想切回 Claude 官方默认模型，就不再设置任何 env，如下所示。
{
"envds": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "YOUR_DEEPSEEK_API_KEY",
"ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
},
"envark": {
"ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
"ANTHROPIC_AUTH_TOKEN": "YOUR_ARK_API_KEY",
"API_TIMEOUT_MS": "3000000",
"ANTHROPIC_MODEL": "ark-code-latest"
},
"envzp": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_ZHIPU_API_KEY",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"API_TIMEOUT_MS": "3000000"
},
"envkc": {
"ANTHROPIC_BASE_URL": "https://api.kimi.com/coding/",
"ANTHROPIC_AUTH_TOKEN": "YOUR_KIMI_API_KEY",
"API_TIMEOUT_MS": "3000000"
}
}这个方法的好处是，几家模型提供商的配置集中在同一个文件里，每次切换只用打开文件改一下相应的字段名就好。
兴之所志
2026-05-23